home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3s / wcstod.z / wcstod
Encoding:
Text File  |  2002-10-03  |  5.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. wwwwccccssssttttoooodddd((((3333SSSS))))                                                          wwwwccccssssttttoooodddd((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _wwww_cccc_ssss_tttt_oooo_dddd_:::: _wwww_cccc_ssss_tttt_oooo_dddd_,,,, _wwww_cccc_ssss_tttt_oooo_ffff_,,,, _wwww_cccc_ssss_tttt_oooo_llll_dddd - convert wide-character string to
  10.      floating-point number
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>>
  14.  
  15.      _dddd_oooo_uuuu_bbbb_llll_eeee _wwww_cccc_ssss_tttt_oooo_dddd _((((_cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_nnnn_pppp_tttt_rrrr_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_****_eeee_nnnn_dddd_pppp_tttt_rrrr_))))_;;;;
  16.      _ffff_llll_oooo_aaaa_tttt _wwww_cccc_ssss_tttt_oooo_ffff _((((_cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_nnnn_pppp_tttt_rrrr_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_****_eeee_nnnn_dddd_pppp_tttt_rrrr_))))_;;;;
  17.      _llll_oooo_nnnn_gggg _dddd_oooo_uuuu_bbbb_llll_eeee _wwww_cccc_ssss_tttt_oooo_llll_dddd _((((_cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_nnnn_pppp_tttt_rrrr_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_****_eeee_nnnn_dddd_pppp_tttt_rrrr_))))_;;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The _wwww_cccc_ssss_tttt_oooo_dddd, _wwww_cccc_ssss_tttt_oooo_ffff, and _wwww_cccc_ssss_tttt_oooo_llll_dddd functions return as a double-precision,
  21.      single-precision, or long double-precision floating-point number
  22.      respectively the value represented by the wide-character string pointed
  23.      to by _n_p_t_r.  This function scans the string up to the first unrecognized
  24.      character.
  25.  
  26.      _wwww_cccc_ssss_tttt_oooo_dddd recognizes an optional string of ``white-space'' characters [as
  27.      defined by _iiii_ssss_wwww_ssss_pppp_aaaa_cccc_eeee in _wwww_cccc_tttt_yyyy_pppp_eeee(3S)], then an optional sign, then a string
  28.      of digits optionally containing a decimal-point character [as specified
  29.      by the current locale; see _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)], then an optional exponent part
  30.      including an _eeee or _EEEE followed by an optional sign, followed by an integer.
  31.  
  32.      If the value of _e_n_d_p_t_r is not _((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_****_))))_NNNN_UUUU_LLLL_LLLL, a pointer to the
  33.      character terminating the scan is returned in the location pointed to by
  34.      _e_n_d_p_t_r.  If no number can be formed, *_e_n_d_p_t_r is set to _n_p_t_r, and zero is
  35.      returned.
  36.  
  37. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  38.      _wwww_cccc_tttt_yyyy_pppp_eeee(3S),
  39.  
  40. NNNNOOOOTTTTEEEE
  41.      Precision may be silently lost if the number of digits comprising the
  42.      floating-point number (i.e., not including the exponent) exceeds the
  43.      value of the constant DBL_DIG (LDBL_DIG) in _<<<<_ffff_llll_oooo_aaaa_tttt_...._hhhh_>>>>.
  44.      The _wwww_cccc_ssss_tttt_oooo_ffff_((((_)))) and _wwww_cccc_ssss_tttt_oooo_llll_dddd_((((_)))) functions are supported in n32 and 64 bit C
  45.      Libraries for IRIX 6.5.18 and later versions as one of C99 features.
  46.  
  47. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  48.      If the correct value would cause overflow, _++++_////_----_HHHH_UUUU_GGGG_EEEE______VVVV_AAAA_LLLL is returned
  49.      (according to the sign of the value), and _eeee_rrrr_rrrr_nnnn_oooo is set to _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE.
  50.  
  51.      If the correct value would cause underflow, zero is returned and _eeee_rrrr_rrrr_nnnn_oooo is
  52.      set to _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.